Unresolved External Symbol

释义 Definition

“Unresolved external symbol” 指在编译/链接阶段，链接器发现代码中引用了某个外部符号（如函数、变量、类成员等），但在任何目标文件或库中都找不到该符号的定义，因此无法完成链接，常见于 C/C++（以及相关工具链）的链接错误信息。

发音 Pronunciation (IPA)

/ˌʌnrɪˈzɑlvd ɪkˈstɝːnəl ˈsɪmbəl/

例句 Examples

The linker reported an unresolved external symbol for main.
链接器报告 main 出现“unresolved external symbol”（未解析的外部符号）。

After we updated the library, the build failed with an unresolved external symbol because the function signature changed and the old object file still referenced the previous name.
更新库之后，构建因“unresolved external symbol”失败，因为函数签名变了，而旧的目标文件仍在引用先前的符号名。

词源 Etymology

这是编译链接术语的组合短语：unresolved（未被解析/解决）+ external（外部的，指来自其他编译单元或库）+ symbol（符号，指链接器层面可识别的名称/标识，如函数名、变量名，经常还涉及名称修饰 name mangling）。整体来自链接器报错语境，属于工程实践中固定搭配。

相关词 Related Words

• Linker
• Symbol
• Undefined Reference
• Static Library
• Dynamic Library
• Name Mangling
• Header
• Object File

文学与著作 Literary Works

• *Programming: Principles and Practice Using C++*（Bjarne Stroustrup）——在构建与链接相关章节/示例中常涉及此类链接错误语境。
• The C++ Programming Language（Bjarne Stroustrup）——讨论分离编译、链接与符号相关问题时经常出现类似术语。
• C++ Primer（Lippman, Lajoie, Moo）——在编译/链接错误与多文件工程示例中常见该类错误信息的讨论。